home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_usrdoc / ASAPM-2.2 / README.{__ < prev    next >
Text File  |  1999-09-17  |  4KB  |  102 lines
  1. asapm is Advanced Power Management monitor utility for X Windows
  2. Copyright (c) 1998  Albert Dorofeev <Albert@mail.dma.be>
  3. For the updates check http://bewoner.dma.be/Albert/linux/
  4.  
  5. Description:
  6. ============
  7.  
  8. This is an AfterStep look & feel Advanced Power Management (APM) 
  9. monitor for laptops and notebook PCs running Linux or FreeBSD 
  10. and X Windows.
  11.  
  12. I have a laptop myself and I ran xapm when I used fvwm window
  13. manager. Then I switched over to AfterStep which looks really
  14. beautiful. (see http://www.afterstep.org/). I wanted some
  15. nice applet to put it in my Wharf. Well, to make the story
  16. short, I did not find any that I liked. The best bet was then
  17. to write my own. So, I just grabbed a X book and tried.
  18.  
  19. The interface evolved with the time and I am finally beginning
  20. to like the way it looks. I may stop writing new versions for
  21. a while now. Let me know if there are any neat options you'd
  22. like to see though.
  23.  
  24. Basically, the tool shows you the following:
  25. - The bar-like indicator of the charge left in the battery
  26.   which appears on the left side and is battery-shaped.
  27.   The bottom part shows the charge left in the battery.
  28.   The colors may be customized.
  29. - The top line works as a pair of indicators. You see there
  30.   a battery outline which is "green" when the battery status
  31.   is high, "yellow" when the battery status is low, and
  32.   "red" when the battery status is critical. The colors may
  33.   be customized. The definition of the high, low, critical
  34.   status may be mine :-) or APM daemon's - you can choose.
  35.   The AC plug outline is black while you run the computer
  36.   on the battery and it turns "green" when your computer
  37.   is connected to the mains.
  38. - The second line is the charge left in the battery in percent.
  39.   If the APM daemon does not return a good value for it, the
  40.   display is disabled.
  41. - The third line is the estimate of the time left before the
  42.   complete discharge of the battery. This estimate is either
  43.   provided by the APM daemon or is calculated by this tool
  44.   itself. When there is no estimate available the display is
  45.   disabled.
  46.  
  47. The tool parses the resource files if such are available and you
  48. can specify certain commands to be executed in reaction to certain
  49. APM events. For example, you may use hdparm (8) to change the 
  50. timeouts for the hard disk spin-down when you switch to/from the
  51. AC power. Just be careful with that tool, okay? You can also
  52. ask asapm to suspend the computer when the power reaches down to,
  53. say, 10% (use apm (1)) in case you forget to shut down your computer 
  54. and go to sleep (talking from my own experience here :-).
  55. The default location for the resource file ~/.asapmrc (what
  56. a surprise!) and can be changed with -rc option.
  57.  
  58. Actually, there are more customization options then I personally want. 
  59. There are tons of them. Check the man page for the details 
  60. (nroff -man asapm.man | more) or run asapm -h for a brief description.
  61. The syntax of the asapm resource file is described in there too.
  62.  
  63. The program may be used directly or in the Afterstep "wharf". It also 
  64. supports the WindowMaker docker (-withdrawn option). It may be used 
  65. in all other window managers as well. I tried it with fvwm2 and it looks
  66. quite nice sitting in a corner as an icon.
  67.  
  68. You may want to have a look in the CHANGES file for the history of updates.
  69.  
  70. Credits:
  71. ========
  72.  
  73. Great many thanks to 
  74.     Jim Knoble <jmknoble@pobox.com>
  75.     Brett Taylor <brett@peloton.physics.montana.edu>
  76.     Brian Handy <handy@physics.montana.edu> 
  77.     John Schweitzer <thanatos@chaeron.dyn.ml.org>
  78.     Dagmar d'Surreal <dagmar@estates.ml.org>
  79. for their bright ideas, new features, improved looks, testing, 
  80. patches and moral support!
  81.  
  82. The original inspiration from the apmx tool by Jeff Chua <jchua@fedex.com>. 
  83. There is some code taken from his source - the "/proc/apm" access.
  84. The code for FreeBSD APM device access comes from apm tool by 
  85. Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>.
  86. The ideas for the digits on the screen come from asclock by 
  87. Beat Christen <bchriste@iiic.ethz.ch> and wmapm by 
  88. Chris D. Faulhaber <jedgar@speck.ml.org>.
  89.  
  90. Distribution:
  91. =============
  92.  
  93. The application and the source code are under GPL. See LICENSE 
  94. file for details.
  95.  
  96. Naturally, I would like to hear of all changes and improvements 
  97. made to this utility.
  98.  
  99. Enjoy and may the source be with you,
  100. Albert "Tigr"
  101.  
  102.